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IMPORTANT ! 


DUPLICATE 

THIS 

DISKETTE 
EEFORE 
USING 
THIS 
PROGRAM ! 


This APX diskette is unnotched to protect the software against 
accidental erasure. However, this protection also prevents a program 
from storing information on the diskette. The program you've 
purchased involves storing information. Therefore, before you can use 
the program, you must duplicate the contents of the diskette onto a 
notched diskette that doesn't have a write-protect tab covering the 
notch. 

To duplicate the diskette, call the Disk Operating System (DOS) menu 
and select option J, Duplicate Disk. You can use this option with a 
single disk drive by manually swapping source (the APX diskette) and 
destination (a notched diskette) until the duplication process is 
complete. You can also use this option with multiple disk drive 
systems by inserting source and destination diskettes in two separate 
drives and letting the duplication process proceed automatically. 
(Note. This option copies sector by sector. Therefore, when the 
duplication is complete, any files previously stored on the 
destination diskette will have been destroyed.) 
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INTRODUCTION 




OVERVIEW 

INSTEDIT is a character set editor that simultaneously displays the character you're 
editing in all six character modes (the three supported by ATARI BASIC and the other 
three supported only by the hardware)* As you use a joystick controller to edit the 
character in an eight-by-eight grid, you see immediately how each change affects the 
character in every mode* When you want to experiment with combining characters, merging 
them to create larger objects, you can use INSTEDIT's memo pad mode, which lets you work 
in the lower half of the screen in any of the six character modes* It can even help you 
create objects for use with the ATARI Computer's system of player missile graphics* 

In addition to point-by-point character editing, INSTEDIT's menu options let you change 
the whole character at once* You may change it to appear as it does in the ROM character 
set, erase it, restore its original shape, invert the colors of the letter and 
background, copy the form of another letter, create a mirror image, rotate it ninety 
degrees at a time, and shift its position within the matrix* Other options let you save a 
character set for further work later and load in a stored character set* Once you've 
finished editing a set, INSTEDIT will store all or part of your character data to 
diskette or cassette in the form of BASIC DATA statements, or assembler source code using 
the *BYTE directive, or even an entire BASIC subroutine for incorporating your new 
character set into an existing program* 


REQUIRED ACCESSORIES 
Cassette version 
16K RAM 

ATARI 410 Program Recorder 
Diskette version 
24K RAM 

ATARI 810 Disk Drive 

ATARI BASIC Language Cartridge 
One ATARI Joystick Controller 


CONTACTING THE AUTHOR 

Users wishing to contact the author about INSTEDIT may write to him at* 

14400 El m Street 

Oak Park, Michigan 48237 
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GETTING STARTED 


LOADING INSTEDIT INTO COMPUTER MEMORY 

1* Plug your joystick controller into the first (the leftmost) controller jack at the 
front of your computer console* 

2* Insert the ATARI BASIC Language Cartridge in the (Left Cartridge) slot of your 
computer* 

3* If you have the cassette version of INSTEDIT * 

( Note * If your system has only 16K of RAM and you have an ATARI 850 Interface 
Module, make sure the interface module is turned off* You may turn it on after step 
b*) 


a* Turn on your TV set* 

b* Turn on your computer and connect your program recorder to the computer and to a 
wall outlet* 

c* Slide the INSTEDIT cassette into the program recorder's cassette holder and press 
REWIND on the recorder until the tape rewinds completely* Then press PLAY* 

d* Type CLOAD on your computer and then press the RETURN key two times* The tape 
will load into computer memory* 

e* After the tape finishes loading, the word READY will display on your TV screen* 
Type RUN and press the RETURN key* 

If you have the diskette version of INSTEDIT t 

a* Turn on your disk drive* 

b* When the BUSY light goes out, open the disk drive door and insert the INSTEDIT 
diskette with the label in the lower right-hand corner nearest to you* 

c* Turn on your computer and your TV set, type RUN "DJINSTEDIT", and press the 
RETURN key* If you're using more than one disk drive, remember to follow the device 
initial (D) with the number of the drive containing the INSTEDIT diskette (e*g*, RUN 
"D2;iNSTEDIT" for disk drive two)* 

4* After a few seconds of setup time, INSTEDIT's five-part screen, described in the next 
section, will display* 



USING INSTEDIT 


INTRODUCTION 

Why create custom character sets? 

Creating custom character sets can serve a number of purposes* For example* you might 
want a custom character set for your computer programs for the same reason you'd want a 
changeable typehead on a typewriter! you may need special math symbols* chemistry 
symbols* foreign language alphabets* or a special typeface to set the mood for a 
particular program* 

On a more sophisticated level* you may want to develop special graphics characters as a 
substitute for the plot-and-draw method for producing high-resolution graphics* By 
positioning several characters together* you can create a high-res picture as easily as 
you can print a character string* You can achieve the same resolution with custom mode 0 
characters as you can with mode 8 drawing* The difference is that by using specially 
designed characters* you avoid the high memory usage required for mode 8* as well as the 
tedious and slow plotting of each point and line* You can put the finished drawing on the 
screen much more quickly* achieving smooth animation in BASIC just by printing strings of 
characters in succession* each representing a figure in a different position. 

Using machine-language subroutines* you can extend your work into developing 
professional-quality* fast-action arcade games with full color* high-res animation* Using 
custom character sets in this way introduces a new level of graphics power and 
flexibility* If you're familiar with the ATARI computer's player missile graphics system* 
you can even use INSTEDIT to design players* 

How INSTEDIT works 

When you press a key on your ATARI computer's keyboard* one of 128 different characters 
appears on your TV screen. The shape of each character is determined by a collection of 
data stored in computer memory* INSTEDIT lets you change this data* and thus the shape of 
the characters* as easily as drawing a picture* 

The procedure is as follows* You use the computer's keyboard to select the character you 
want to edit* A large-scale model of this character then displays in an eight-by-eight 
grid* Using a joystick* you move a cursor to any of the 64 squares and modify the 
character's shape* You modify by pressing the red trigger button to add or remove color 
(if color is already present* pressing the button erases it; if color is absent* pressing 
the button adds color)* As you change the model character* these changes appear in the 
samples of the character* which are displayed in each character mode* Additional editing 
features let you experiment further with your characters* You can save your finished set 
on diskette or cassette for future editing* or you can incorporate it into a BASIC or 
assembly language program* 


-V 
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INSTEDIT'S MENU 


INSTEDIT's display screen is divided into five areas* It looks roughly as fallows? 
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Figure 1 


INSTEDIT's 


Disp lay Screen 


(1) Submenu of advanced editing features, usable with the main menu's EDIT option* 

(2) Frame for the 8-x-8 character grid* Initially, this frame contains the program 
title* Prompts also display in this area* 

(3) Main menu of program options* Underneath the options are three sample rows of the 
model character (?) in mode 0, in both normal and inverse video* 

(4) Mode 0 display of the entire character set (in Internal Character Set order)* 

(5) The model character (?) displayed in the other five character modes * in this order? 

(1) Instruction Register (IR) Mode 3 

(2) IR Mode 4 
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(3) IR Mode 6 (BASIC GR. Mode 1) 

(4) IR Mode 5 

(5) IR Mode 7 (BASIC GR. Mode 2) 


IR Modes 3, 4, and 5 are character modes supported by the hardware, but not by ATARI 

BASIC. The appendix discusses these hardware modes, sometimes referred to in ATARI 
manuals as ANTIC modes. 


* 


i 


MENU SELECTIONS 

You select a menu function by pressing the key matching the first letter of the function* 

The functions are as follows* 

E EDIT 

When you press the letter "E”, the prompt, WHICH CHARACTER TO EDIT?, displays in the 
center frame* Type in your desired character, using the LOWR or CTRL key, as 
appropriate, to edit a lowercase or control character* If your desired character is 
an editing symbol, such as one of the arrows, you don't need to press the ESC key 
before pressing the combination of keys used to carry out the edit function* 

After you select a character to edit, your choice displays at the top of the main 
menu and in each of the screen locations initially occupied by the question mark* In 
addition, a large-scale model displays in the center frame, along with a yellow 
cursor* 

Use your joystick to move the cursor within the frame to edit the character* Press 
the red trigger button to change the square — to color an empty square, or erase a 
colored square* Each of the sample characters reflects your changes as soon as they 
occur} however, the menu and prompt lettering remain in the standard character set* 

While in EDIT mode, you can also use the submenu options of ATARI, BLANK, COPY, 
INVERT, MIRROR, RESTORE, and TWIST, explained below* After you finish editing a 
character, you can go to another by pressing the "E" again, or you can select the 
SAVE, LOAD, or WRITE function* 

The Submenu functions are as follows* Select a function by pressing the matching 
letter* 

A ATARI 

Restores the character being edited to its normal (ROM set) appearance* 

B BLANK 

Clears the whole character currently being edited, giving you a clean 
background on which to design a new character* 
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C COPY 


Replaces the character currently being edited with any other character. After 
pressing "C", the prompt, WHICH CHARACTER TO COPY?, displays in the center 
frame. Type in your desired character. The current character then becomes a 
duplicate of that character. 

I INVERT 

Reverses the colors of the current pattern. All colored squares change to 
background and vice versa. 

M MIRROR 

Changes the character to the mirror image of its present shape. If the 
character is symmetrical, no change is apparent. 

R RESTORE 

Restores the original character as it appeared the last time you pressed "E" 
for EDIT. Any intermediate changes are lost. 

T TWIST 

Rotates the entire character on its axis ninety degrees clockwise each time you 
press "T". 

SHIFT 

Depending on which arrow key you press* shifts the whole character up a line* 
down a line, one square to the left* or one square to the right* You can repeat 
the function by holding down an arrow key* 


S SAVE , 

Use this function to store the complete current character set as a data file on 
diskette or cassette* You can then continue editing the set later* or you can 
incorporate it into another program* 

When you press "S"* the prompt either asks you to name the data file or to position 
the cassette* depending on whether your disk drive is connected* Diskette users 
enter a file name and press the RETURN key* Don't include an extender* the program 
auomatically adds the extender "♦SET" to your file name* to identify it as a 
character set data file* Cassette users position the tape* press the PLAY and RECORD 
buttons on their program recorder* and press the RETURN key on the computer keyboard* 

When the program finishes storing the character set to diskette or cassette* the 
message SAVE COMPLETE displays in the center frame* If an error occurs so that the 
program can't complete saving your character set* the original prompt redisplays in 
the center frame* Try another diskette* the one you're using might contain no free 
sectors* be damaged* or contain a write-protected file of the same name as the one 
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you're trying to save* 


To cancel a SAVE t diskette users should press the RETURN key instead of entering a 
file name* and cassette users should press the ESC key instead of the RETURN key* In 
each case* the message CANCEL SAVE displays in the center frame* 

Although editing character sets might look like drawing* what is really occurring is 
plain old data manipulation* As is true any time you work with data* saving your 
revisions every so often is good practice* This protects you from calamities such as 
your cat pulling out the cord from the wall outlet* thereby wiping out an 
afternoon's worth of work* How often you save you work depends on how much of it 
you're willing to lose! 

L LOAD 

Use this function to load a previously saved set from diskette or cassette* If you 
have a disk drive connected* the program asks you to enter the name of the file to 
be loaded and then press the RETURN key* Enter only the name you saved* the program 
automatically appends the extender "♦SET'* to your file name* To recall the name of a 
file, enter an asterisk (*) — the first ten data files in the directory will display 
at the top of the Submenu area* Display additional file names by pressing the 
asterisk again* Cassette users are asked to position the correct tape* press the 
PLAY button on the program recorder* and press the RETURN key on the computer 
keyboard* 

The message LOAD COMPLETE displays after a successful load* The original prompt 
redisplays after an unsuccessful load* In the latter case* check that your diskette 
or cassette containing the desired saved sets are correctly positioned* Diskette 
users should avoid using any of the I/O commands (Save* Load* or Write) without 
first making sure their diskette is inserted and the disk drive door is dosed* 
Otherwise* the drive will keep trying to carry out the program's instructions until 
a timeout occurs* This activity could continue for a couple of minutes* during which 
time you might think the program has crashed* If one of these situations occurs* 
just be patient until the timeout occurs and then correct the problem and continue* 

Diskette users can cancel this function by pressing the RETURN key without first 
entering a file name* Cassette users can do so by pressing the ESC key instead of 
the RETURN key. 

W WRITE 

Use this function to store a file on diskette or cassette in such a form that you 
can incorporate it into an existing program* To provide flexible alternatives for 
fullest use of your newly defined characters* INSTEDIT can write your character set 
data in any of three formats* This function is one of INSTEDIT's more powerful 
features* and you should read this section carefully to understand how to use the 
WRITE function* 

When you press "W"* a submenu displays the three WRITE options* (!) BASIC* (2) DATA* 
and (3) .BYTE* Explanations of these options follow* 

(1) BASIC 
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Use this option to write an entire BASIC subroutine to cassette or diskette that 
integrates your new character set into an existing program* In the INSTEDIT program* 
the character data is stored as a string* When this string is defined by the program 
statements of the subroutine* loading the character set from an external storage 
device isn't necessary* The program loads and runs with your new set* This method 
uses a relatively large amount of memory* but it's the only way known by the author 
for instantly installing a whole new character set in a cassette-based program* 

The subroutine this option writes in LIST format defines and installs your new set* 

It uses program lines 0 and 30000-31300* therefore* your program can't contain these 
line numbers* It also uses the variable names QQ$ to contain the string data and 
BASE to hold the location of the new character set in memory* thus* make sure your 
program doesn't use these names* You can merge the subroutine* in LIST format* with 
a program already in memory by using the ENTER command* 

When you select this option* a prompt tells you to press the RETURN key when you're 
ready* Diskette users now insert the diskette to be used* cassette users position 
the tape and press the PLAY and RECORD buttons on their program recorder* All users 
then press the RETURN key on their computer keyboard* 

The program then writes the subroutine to diskette or cassette* It might take a 
minute or so to write the routine (consider how long it would take you to type in 
all that data!)* The message WRITE DONE displays after a completed operation* The 
original prompt redisplays after an incomplete attempt* In the latter case* check 
your cassette or diskette to make sure everything is set up correctly and try again* 

To cancel the option* press the ESC key instead of the RETURN key after the initial 
prompt* 

To merge the program with one previously saved* first load the saved program into 
computer memory* Next* cassette users type ENTER "C*"* position the tape containing 
the LISTed subroutine* press the PLAY button on the program recorder and the RETURN 
key on the computer keyboard* Diskette users type ENTER "DiLOADSET^LST" (which is 
the filespec the WRITE subroutine assigns to the LIST file)* and press the RETURN 
key* The character set subroutine then merges with the program in memory* 

One final step is absolutely necessary * To order the variable table* which has to 
be done to make the combined program work* you must then? 

(1) LIST the combined program to diskette or cassette by typing LIST "C*" or 
LIST "Difilespec"* as appropriate* 

(2) Type NEW after the LIST is complete* 

(3) Enter the program into computer memory by typing ENTER“C*" or ENTER 
"Dlfilespec"* as appropriate* 

You're now ready to SAVE or CSAVE and RUN your combined program* 

A final word of caution* The pointer at memory location 756 (decimal)* which tells 
the computer where the character set is stored* is reset to the default value of 224 


- 8 - 



after every GRAPHICS command* To retain the use of your new character set* this 
pointer must contain the location of your set* As stated earlier* that location is 
stored in the variable BASE* Therefore* after every GRAPHICS command* insert the 
statement POKE 756*BASE to keep your new set in use* You may switch back to the 
ATARI computer's character set at any time in your program by inserting the 
statement POKE 756*224* 

(2) DATA 

Use this option to save any character or group of characters to diskette or cassette in 
the form of numbered BASIC DATA statements* This option is useful in cases where you have 
only a couple of characters to be altered and don't want to use the memory-intensive 
subroutine produced by the BASIC option* It's also suitable for occasions when you want 
to distribute printed listings of your program* Because the BASIC option stores the 
character data as ATASCII characters rather than as numbers* it's very difficult to 
produce readable listings of programs using that subroutine* The DATA option is also 
ideal for using the characters created with INSTEDIT for player missile graphics* Because 
both players and text characters are eight bits wide* character data can be POKEd into 
player memory without alteration* and it will produce a player the same shape as the 
character* 

After selecting the DATA option* a prompt displays for entering the name of your data 
file* if a disk drive is connected* under which the program will save your character set 
data* The program automatically adds the extender *DAT to your file name so that you'll 
recognize it as a DATA statement file* Type in your desired file name and press the 
RETURN key* 

Next* the program prompts all users to enter the starting line number for the statements 
and then the increment between line numbers* If* for example* you enter 1000 as your 
starting line number and 10 as your increment value* the resulting file will contain 
statements in the form* 

1000 DATA 0,0,0, ♦ ♦ ♦ ♦ 

1010 DATA 159,46,57, ♦♦ ♦ 

The program then asks users to press the key of the first letter to be saved to the file 
and the number of consecutive letters appearing directly after that letter that are to be 
written to the file* Consecutive letters mean the order of the Internal Character Set 
(corresponding to the order of the complete character set in the middle area of the 
INSTEDIT display)* not ATASCII order* A listing of consecutive order is on page 55 of 
your ATARI BASIC Reference Manual * Hence, if you want to write a file with data for the 
letters A through Z* you first press "A" and then "26" to specify the number of 
characters to be saved* To write a file containing the whole set* you first press the 
SPACE BAR (which is the first character in the Internal Character Set)* and then type 128 
for the number of characters* 

After you enter this information* the prompt HIT RETURN WHEN READY displays* You can now 
insert the proper diskette or cassette* When you press the RETURN key* the program will 
write the selected characters to the file in LIST format* The message WRITE DONE displays 
after the program completes the write activity* The HIT RETURN WHEN READY prompt 
redisplays if the program can't complete the activity* 
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You can cancel the option by pressing the ESC key instead of the RETURN key* 


The program stores character data in groups of 24 bytes (three characters) per program 
line* You can merge the completed data file with another BASIC file by loading the latter 
and then using the ENTER command* 

(3) *BYTE 

Use this option to produce data files suitable for immediate integration into assembly 
language source code* The option is similar to the DATA option* Instead of writing the 
data file in the form of numbered BASIC DATA statements, this option, however, produces 
numbered lines beginning with the *BYTE directive and followed by the data in hexidecimal 
form* The output produced takes this form* 

1000 ♦ BYTE $00, $49, $2F, $FC, $4B, $QB, $BE , $C7 

You can enter the data file directly to the Editor using the Command ENTER #C* or ENTER 
#D*filespec, as appropriate* Diskette files produced by this option have the extender 
♦BYT ♦ The *BYTE option writes only one character's (eight bytes) worth of data per line* 


MEMO PAD MODE— OPTION key 

Press the OPTION key to enter and exit Memo Pad mode* This mode, like the ATARI memo pad, 
lets you print any combination of characters just to see how they look* INSTEDIT, 
however, doesn't limit you to graphics mode 0* You can choose any of the six character 
modes in which to print combinations of characters* 

After pressing the OPTION key, a prompt tells you to type a number between 0 and 7* Type 
in 0, 1, or 2 to set up the bottom half of the screen in the BASIC graphics mode of the 
corresponding number* Type in 3, 4, or 5 to set the Memo Pad to the corresponding IR 
mode* Type 6 to use the Memo Pad but not clear the bottom of the screen, which usually 
occurs when you choose a new mode* This last choice lets you go back and forth from EDIT 
mode to Memo Pad without changing the contents of the Memo Pad* Type a 7 to restore the 
lower screen to its initial configuration* 

After you choose a mode for the memo pad, the program sets the lower half of the screen 
to that mode* The cursor, which is visible only in BASIC mode 0 and IR mode 3, is 
positioned in the upper right-hand corner of the pad* You can then print characters and 
set up various combinations of edited characters to see their interconnection* You can 
use a group of characters to form one large picture, or you can use several characters 
stacked vertically to create a tall player* 

To return to EDIT mode, press the OPTION key again* The lower half of the screen remains 
the same while you edit characters, until you press the OPTION key again* Once you press 
OPTION, you clear the lower screen by choosing a mode, or you exit by pressing the "7", 
which reinitializes the screen* 
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^F=-f= > L I CCrtT X ON 


NO 


< 1 ) I NSTED I T allows you to view edited characters 
as they appear in I R modes 3,4, and 5- Although a complete 
treatment of the Display List is way beyond the scope of 
this manual « a couple of short BASIC routines are included 
below which will set up a full screen of each of the I R 
modes. These will allow you to experiment with these 
modes, and to use the Script set included with I NSTED IT, 
which requires the use of IR Mode 3. For further 
information on these modes, consult the Appendix. and the 
Selected Bibliography . 


In each case, start with: 

lO GRAPHICS Os DL=PEEK<560)+256*PEEK 561 
For IR Mode 3: 


20 POKE DL+3 , 67 : FOR 1=6 TO 23: 
POKE DL+24. PEEK (560): POKE DL+25, 
65 


POKE DL+1.3: NEXT Is 
PEEK (561): POKE DL-26 , 


For IR Mode 4; 

20 POKE BL+3. 68: FOR 1=6 TO 23: POKE DL+I, 4: NEXT I 

For IF: Mode 5: 


20 POKE DL+3, 69: FOR 1=6 TO 16: POK! 
I; POKE DL+17, PEEK < 560): POKE DL+13, 
DL+19, 65 


5 


DL+I, 
PEEK <561) 


NEXT 

POKE 


(2) Although the Option I Write routine is very good 
for installing your set in a BASIC program, it takes up a 
fair amount of memory. For those disk users who need to 

several sets during a 
that vou use the 
the LOADSET. L3T file, 
of I NSTED IT (lines 
lines < 30 1 00—3 1 200 > . 
the OPEN statement to 


save memorv. or want to switch 
single program. I would suggest 
initialization routine provided by 
but substitute the Load routine 
2570—2610) for the definition 
Remember to change the filespec in 
the name of vour set data file. 


(3) One way of getting more colors on a Mode 0 or 
Mode 8 screen is by using color artifacts. You will 
notice that if you put dots only in odd or even columns 
(i.e.. without ever putting two dots side-by-side) ? you 


will generate a couple of new colors. 

recommended that vou avoid this for text 

* 

might be useful for graphics characters. 


Wh i 1 e it is 
characters, it 


<4> One promising aoolication that 

c w it 

natural would be to desion a series 


seems to be a 
of characters 



depicting the -face cards of a. deck c-f playing cards. 
Although I haven’t had the time to try my hand,. I would be 
interested in hearing from anyone who designs such a set. 

(5) Using the data generated by Write Option 2, it is 
fairly easy to plot out Mode O characters on a Graphics 
Mode 3 screen, so that text and map-plot graphics can 
appear on the same horizontal line. As an example, use 
Option 2 to generate a file with DATA statements for 26 
letters. Type NEW, ENTER the data, then type in the 
following program: 

10 GRAPHICS 3: DM=PEEK (560) +256 * ( PEEK (561 ) +4 : 

DM=PEEK ( DM ) + 256* PEEK (DM+1): OFF=16SO 

20 FOR 1=1 TO 25: FOR J=0 TO 7: READ A: POKE DM +0FF 

+J *40 +1 , A: NEXT J: NEXT I 

30 GOTO 30 

By varying the offset constant (OFF) , you can 
oosition these characters around the screen, 

K 

(6) As mentioned in the Menu section, the data 
Generated bv Write Option 2 or 3 can be used directly to 

—A * * 

define Players for Player-Missile Graphics, This data can 
be POKEd directly into the area reserved for Player data. 
Just remember that data from more than one character will 
stack up vertically, one byte per horizontal line- Also, 
to save space and time, remove any O data that precedes or 
follows the actual player shape. 

You may want to keep in mind that Player-Missile 
Graphics offers three width options for each Player. 
Therefore, you may make use of INSTEDIT’S display of the 
double— wide characters of Graphics Modes 1 and 2 , as well 
as the large center display (which itself is 1 
max i mum— wi dth player) to visualize the appearance of the 
Players you design in varying widths. 
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TROUBLESHOOT X NG 

(1) Normally, about the only type of problems 
encountered will be related to Input /Output- Examples o-F 
such errors are use of illegal disk file names , trying to 
write to locked files, trying to read non-existent files . 
or trying to read an i mproper 1 y— posi t i oned tape. Instedit 
does not return an error message when a load or save 
fails, but rather returns to the last prompt. This gives 
you an opportunity to check your cassette or disk, make 
sure everything is set up right, and try again, or cancel. 


(2) At most times the user is protected against 
accidental use of the editing keys in a way which would 
interfere with the screen display. However, full editing 
functions are restored when the user is requested to input 
information longer than one character, such as a file 
name. During these times, accidental use of an editing 
function such as the line delete may disrupt the display. 
If this occurs, complete the function in process. Then, 
hit the OPTION key to enter Nemo Pad mode. Select option 
7, Exit. This will restore the screen to its original 
conf i gurati on - 


< 3 ) While the Break key has been disabled, the System 
Reset key still works. If you accidentally hit Reset, you 
can restart the program by typing RUN. If you do, 

however, all previous character data will be lost. In 
order to save your data, before typing RUN type GOTO 2000. 
This will let you enter the Save routine without clearing 
character data. When the "SAVE COMPLETE" 
you may hit Reset and RUN the program. 


message appears. 


* 


i 




ABOUT TH 


ROGRAH 


In order to understand how INSTEDIT works, a fair 
understanding of some o f the spec i el herd were -f saiures of 
the ATARI computers is necessary. In perticular, INSTEDIT 
makes use of PI ever —Mi ssi 1 e Graphics, mixed Dipl ay Lists, 
and character— set indirection . A review of some of the 
literature dealing with these topics will go a long way 
toward aiding an under stand i ng of how the program works. 
References to some of these sources appear in the Selected 
Bibliography at the end of this manual . 

Wh lie not a line-by-line analysis of the program, the 
following general description should give you an idea of 
the program's logic and organ i zati on . 

The i ni t i al i zat i on routine starts at the back of the 
prooram, at line 30000 , Variables are set up for 
constants, the keyboard is opened as a device, and the 
Handler Table is checked to see if a disk device is 
present (30000—30030). Next, strings are dimensioned. 
The most important of these are C$, which will hold the 
new character set data, and PM$, P0 , Pl$ ? etc. , that hold 
the Player Missile Graphics data. Since both P— M 
information and character sets must start on a Ik 
boundary, FILLS is first dimensioned to a length that is 
sufficient to waste the space between the last string data 
( ADR < DS ) and the next highest IK boundary (30060). 

By superimposing the P— M graphics data area and the 
character set data area on the memory area reserved for 
these strings, we can take advantage of the 
irachine— language routines in BASIC that move string data 
around so quickly. In addition, it enables the use of the 
XIO 7 and 11 commands, which move blocks of 255 bytes. 
These commands are tied to the use of strings, and they 
account for the ability of the program to rapidly transfer 
data using only BASIC routines. 

After the strings are initialized, the ROM character 
set is copied to the area of RAM set aside for C$ (30100), 
using a short fnachine— language routine. The Break key is 
disabled, the mixed— mode display is created, and the 
initial screen graphics are drawn (30100 to 31365). 
F" 1 aver —Mi ssi 1 e Graphics are then used to create the center 
frame (Player 2 and Missiles grouped as Player 4), the 
large display character (Player 1), the cursor (Player 0) , 
and the grid background (Player 3). The priority register 
is set so that when the cursor and large characters 
overlap, the cursor changes color . Temporary strings are 
used to transfer data to Player memory, and P— M graphics 
are enabled (31370—31395). After initializing a couple of 
short machine-language routines to shift characters and to 
draw the large center display, the program proceeds to the 
main loop at Line 200. 
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The main loop (200—290) checks the keyboard, the 
console switches, the joystick, and the trigger button, 
each in turn. First to be checked are the Write (205), 
OPTION (207), Edit (210), Save (215), and Load (220). If 
one of these has been hit, the program jumps to the 
appropriate subroutine. In the initial phase, if one of 
these has not been hit, the program branches to the 
routine that alternates the menu colors (300—340) and then 
1 ood s to 200 . 

i 


If in the Edit mode, 
if one is hit, the Shift 
line is executed (235—25 
Invert (260), Mirror (254) 
are also one— line routines 
two— line subroutine at 
sub r out i n e at 400 . 


the arrow keys are checked, 
routine contained on the 


O). Atari (259), Blank ( 

, Restore (270) and Twist 
, while Copy (265) branches 
450, verv similar to the 


and 
same 
255) , 

'“iCT'-k \ 

\ -£_t Ji. / 

to a 
Ed i t 


Next, the stick is checked, and if not used the 

-- . 

program loops back to 200, If the stick has been used, 

the cursor is moved by using the horizontal position 

registers, or moving the string information up as 
ap p r op r i a t e . 

The trigger check occurs at line 230. If the button 

has been pushed, the program branches to the subroutine 

that actually sets and erases the dots (350—390). This 

routine checks the collision register to see if Players 0 
(the cursor) and 1 (the large character) overlap. Next, 

the bit position and byte number of the character are 
calculated based on the horizontal and vertical position 
of the cursor- Finally, 2 is raised to the power 

represented by the bit place, and either added or 

subtracted from the byte total, depending on the value of 
the collision register. 


At this point, we should mention the subroutine at 
Line 10. This is the routine that draws the large 
character, and because it is so frequently used, it is the 
only subroutine which has been placed in front of the main 


1 oop . 

The subroutine at 300— 880 sets up the display of the 
model characters, by POKEing them into display data. The 


Memo Pad routine is at 925 to 995, Save and 
are at 2000 and 2500 respectively, and the 
f i n i sh the sub routine sec t i on at 3000—39 1 0 . 


Load 
Wr i te 


rout i n 
rout i nes 



append I X 


AT AR I ’ 3 "HI DDEN " CHARACTER MODES 


The reason that Atari computers are able to otter 
such a large number o-f Graphics modes is that they use a 
separate graphics mi cr ©processor to handle the screen 
display. This chip receives instructions on how to 
display data from a simple program contained in RAM. It 
you are using BASIC, the computer writes this program 
every time you give a GRAPHICS command. But since this 
pr ogr am is in RAM, it is possible tor i_he user no a± *_er i *_ 
with the POKE command. Several articles have appeared in 
magazines giving instructions on how to change this 
program, called the Display List, so that many ditterent 
graphics modes can appear on the screen at the same cime. 
A step— by— step plan tor creating these mixed Display Lists 
appears in Appendix B ot the Atari Hardware Manual 
(available trom Atari Customer Service) . The key step 
involves changing the DISPLAY instruction. this 
instruction consists ot a number trom 2 to 15. Each time 
it appears, it orders the graphics chip to display one 
line ot a particular mode. For example, POKEing in a 2 
orders the chip to display one line ot Mode O, a 6 orders 
up one line ot Mode 1, a 7 one line ot Mode 2, etc. 
Notice how the numbers 3,4,5, were skipped? These are the 
DISPLAY instructions tor the "hidden" character modes. 


When I tirst tried POKEing those DISPLAY instructions 
into a Mode O Display List, I came up with some pretty 
tunny-looking characters that I really didn't understand. 
In order to tind out the purpose behind these modes, which 
are not supported by BASIC, I had to turn to the Hardware 
Manual . It outlines, in tairly technical terms, some 
hardware teatures which are not explained by the reterence 
material supplied with the computer. 

To help in the explanation o-f these modes, I have 
listed two short programs. The first of these (Listing i) 
demonstrates what is referred to in the Hardware Manual as 
Instruction Register (IR) Mode 3. In Line iu, I F’OKE a 

into bytes 19-26 of the Display List, producing a screen 
which is 1/2 BASIC Graphics Mode O and 1/2 IR Mode 3. 
Next, the whole character set is printed in both modes 
(Line 30). Finally, a few adjacent characters are printed 
in both modes for the purpose of comparison (Lines 40—45). 

When this program is run, the IR Mode 3 characters at 
the bottom of the screen do not a.ppear t. o be much 
different than the mode O. characters at the top. On more 
careful examination, however, some differences can be 
detected. First, there is more room between the rows of 
characters in IR Mode 3. This is seen in nhe f a.ct shat 
while the four diagonal graphics characters in the middle 
of the screen form a diamond shape in Mode O. there is a 



i n 


gap between the top and bottom triangles 
Also, the cursor is taller in that mode. 


1 R Mode 3, 
The second 


difference occurs only in the last 32 characters of the I R 
Mode 3 set. These characters appear to be shifted, so 
that the top part of the character has been cut off and 
moved below the bottom of the character. 




According to the Hardware Manual , there is a simple 
reason for these differences. By creating a longer block 
for these character, and having some appear at the top of 
the block, and some at the bottom, the user can create a 
custom character set with true descenders for lower case 

letters like “y” and "p” , In order to explain exactly how 

this mode accommodates these changes, however, we must 
first review the method by which the computer determines 
the shape of a character. 

When the computer wants to display screen data as a 
graphics character, it must look up the shape of the 

character in a table stored in memory. To find this 
table, it looks up its location in a pointer held in 

memory location 756 (decimal). Normally, this pointer 

holds the number 224, because the ROM character data is 

stored starting at page 224 (this is equal to memory 
location 57344, decimal). If you are using a custom 
character set, such as those created with I N3TED I T , the 

pointer will hold the beginning location of that set of 

data in RAM. Each character is represented by 8 bytes of 
data. As each of these bytes is composed of 8 binary- 
digits (or bits), we can picture this data in the form of 
an 8x8 grid. Figure 1 shows how the data for the upper 
and lower case letter "L" is interpreted into the 

character seen on screen. In this drawing, each 

horizontal row represents one byte (the numeric value of 
which is given on the left). Each vertical column 

represents a bit place, A darkened square represents a 
“l" state in the corresponding bit location (the bit 
values, which equal the successive powers of 2 from 2 to 
the 0 (1) to 2 to the 7th (128) are shown at the too of 

s 

each column). So, for example, no squares are darkened in 

the top row of Figure 1(a), and therefore the first byte 

has a value of O, In the second through sixth rows, where 

bits 5 and 6 are darkened, the byte value is 96 (64+32), 

I n IR Mode 3, however, these same characters are set 
up in a 10x8 grid. Two blank scan lines are inserted 
below each of the first 96 characters (see Figure 2(a)), 
The last 32 characters, which include the lower— case 

alphabet, receive special handling. When one of these 
characters is set up in the grid, the first two bytes are 
shifted down to the bottom two lines (see Figure 2(b)). 

This shift of the last 32 characters means that thev use 

* 

the bottom 3 lines of the grid, while the other characters 
use the top 3 lines, thus enabling the use of the bottom 
two lines for descenders, A practical example of the use 
of this mode can be seen in the Script set which is 
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included with INSTEDXT. You will note that while the mode 
accommodates the characters with descenders very well. the 
tall characters such a.s the lower-case 11 h " and 11 d" must be 
transferred to the spot reserved for their respective 
Control -characters, so that they will not he shifted down, 
and can attain their full height. 

The other two hardware-supported character modes are 
demonstrated by the program in Listing 2. Lines 10-20 of 

that program set up the screen half in IR Mode 4, and half 

in IR Mode 5. Line 30 prints the full character set in 
each mode. Line 40 changes the background color for 
better visibility. The rest of the program enables the 
use of the console switches to change the color and 
luminescence value of each register. The SELECT button 
determines the register, START changes the color of that 

register, and OPTION the brightness. 

These two modes are 4-color character 
only difference between these two modes is that 
characters are twice as high as those of 
Unlike BASIC modes 1 and 2, these IR Modes can 
within a particular character. 

Upon looking at the standard character set in these 
two modes, it will be a.p parent that these modes are not 

really suitable for text characters. When used with 
custom-designed graphics character sets. however, 

four— color graphics with the same resolution as BASIC 
Graphics mode 7 can be created, and placed on the screen 
just by PRINT ing a string of characters. 


modes. The 
IR Mode 5 
IR Mode 4. 
mix colors 


To enable this colorful display, the computer divides 
each byte of character display data into 4 groups of 2 
bits each. These groups determine the color of the four 
pixels per row. The four possible combination produce the 
following colors: 

Neither bit set — displays the background 
color (register 4) 


Right bit set — displays the color in 
register O 

Left bit set displays the color in register 1 


Both set — displays the color in 
for normal video, and the color in 
for inverse video characters 


regi ster 
regi ster 




Because two bits are needed to determine 
each pixel, the horizontal resolution is 
Figure 3 shows how this affects letters in 
character set. You should be able to verif 
by changing the color registers in the 
d oo r am bv usino the console switches as ex pi 

i *" * *- r 


the color of 

cut in half. 

the existing 

v this effect 
* 

demon si rat i on 
ained above. 



0 

1 
r> 


REM ** LISTING 1 
REM ** DEMO OF IR MODE 3 
by Sheldon Leemon 


SET UP MIXED-MODE SCREEN 


REM ** 

3 REM ** 

5 REM ** 

6 REM ** 

10 7 CHR* ( 125) : X=PEEK (560) +PEEK (561) *256+19; FOR 1=0 TO 7:P0KE X 

20 NEXT I: POKE X+3,65:P0KE X +9, PEEK (560) : POKE X + 10, PEEK (561 ) 

21 REM * 

25 REM * SET UP COMPARISON CHARACTERS 

26 REM * 

30 GOSU8 60; POSITION 2 ? 17: GOSUB 60 


1,3 


lO. 12 
lO, 13 
lO, 14 
lO, 15 


CHRS(6) ;CHR$(7) 

CH R* (7) ; CHR$ (6) ; " 

CHRS (6) ; CH R* (7) ; H 
CHR*<7) sCHR*<6> ; POSITION 15, 10 


LI " ; CHR$ ( 160) 

11 ; CHR$ ( 1 60 ) 


40 POSITION 

41 POSITION 

45 POSITION 

46 POSITION 

50 POKE 752, 

51 REM * 

55 GOTO 55 

56 REM * 

60 FOR 1=0 TO 127:2 CHR$ (27) : CHR$ ( I ) ; ; NEXT I ; RETURN 


ii 


!l 


LI " 
** 


1: POSITION 2,9:7 CHR*(2S) 


0 REM ** LISTING 2 

1 REM ** DEMO IF IR MODES 4 AND 5 

2 REM ** by Sheldon Leemon 

3 REM ** 

5 REM ** SET UP MIXED-MODE SCREEN 

6 REM ** 


10 

15 

20 

21 


26 

30 


T i 

- * i. 


.j , i 

36 

40 

41 

45 

46 
50 

cn 

vJjCL 

54 

56 

*=:o 

T-J * 1 

60 

65 

70 

71 
75 
SO 


7 CHR$ ( 125) : X=PEEK (560) +PEEK (561 ) *256+3: POKE X , 69 
FOR 1=3 TO 3: POKE X+I,5:NEXT I : FOR 1=9 TO 16; POKE X+I,4:NEXT I 
POKE X + 1 9 ? 65: POKE X +20, PEEK (560) : POKE X+21 , PEEK (561 ) ; POKE 752, 1 
REM * 

REM * PRINT CHARACTER SETS 


if fi 


REM * 


GQSUB 60:7 ;7 : GOSUB 60: POSITION 0,0:7 CHR* ( 156) : POSITION 1,13 
REM * 

REM * CHANGE BACKGROUND COLOR 
REM * 

FOR DELAY= 1 TO 1500:NEXT DELAY : 7 CHR* (253) : SETCOLOR 4,0,14 
REM * 

REM * COLOR REGISTER CHANGE ROUTINE 
REM * 

R=0:S=5: GOSUB 70 

S=PEEK (53279) : IF S=5 THEN R=R+1 -5* (R=4 ) : GOSUB 70 

IF S=6 THEN C=C+1— 16* (C=15> : SETCOLQR R.C,L: GOSUB 75 

IF S=3 THEN L=L+2— 16* ( L= 14): SETCOLOR R,C,L: GOSUB SO 

FOR DELAY= 1 TO 50: NEXT DELAY: GOTO 52 

FOR 1=1 TO 154:7 CHRS (27 ) ; CHR$ ( I ) : : NEXT I 

FOR 1=156 TO 255:7 CHR$ (27) : CHRS ( I ) % : NEXT I : RETURN 

M=PEEK (703+R) ;C=INT(M/16) :L=M-16*C 

POSITION 2,15:7 "REGISTER "jR: GOSUB 75: GOSUB 30; RETURN 
POSITION 15,15:7 "COLOR " ;C;" " : RETURN 

POSITION 25,15:7 "LUM. " ; L ; " RETURN 
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SELECTED B X Bi X OGRAPHY 


The -following magazine articles will aid the reader 
in understandi no the sub iects of character set editina and 
PI aver —fii ssi 1 e Graphics: 

"Outpost : Atari — Missile Graphics Mysteries Revealed”, 

George Blank, Creative Computing, January 1981, p„176 

" Character Generation on the Atari”, Charles Brannon, 
COMPUTE ! , February 1931, p, 76 

" FT aver —Mi ssi 1 e Graphics with the Atari PCS", Crawford, 
COMPUTE!, January 1931, pp. 66-77 

” An Introduction to Atari Graphics", Crawford and dinner, 
BYTE, January 1931, pp » 1 8—32 

" Designing Your Own Atari Character Sets", Gary Pat c net t , 
COMPUTE?, March 1931, p* 72 

Besides the articles mentioned above, readers who 
have seme technical background will want to consult the 
Atari Personal Computer System Hardware Manual , which is 
available from Atari Customer Service, This manual give 
complete details concerning hardware features. 

Add end ices A and B* which deal with FT aver —Mi ssi 1 e 

■ > -* / 

Graphics and mixing Graphics Modes, will be of particular 
i n t er est . 
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LIMITED WARRANTY ON MEDIA AND HARDWARE ACCESSORIES, 


We, Atari, Tnc», guarantee to you, the original retail purchaser, that the medium on 
which the APX program is recorded and any hardware accessories sold by APX are free from 
defects for thirty days from the date of purchase. Any applicable implied warranties, 
including warranties of merchantability and fitness for a particular purpose, are also 
limited to thirty days from the date of purchase. Some states don't allow limitations on 
a warranty's period, so this limitation might not apply to you. If you discover such a 
defect within the thirty-day period, call APX for a Return Authorization Number, and then 
return the product along with proof of purchase date to APX, We will repair or replace 
the product at our option. 

You void this warranty if the APX product: (1) has been misused or shows signs of 
excessive wear} (2) has been damaged by use with non-ATARI products} or (3) has been 
serviced or modified by anyone other than an Authorized ATARI Service Center. Incidental 
and consequential damages are not covered by this warranty or by any implied warranty, 
Some states don't allow exclusion of incidental or consequential damages, so this 
exclusion might not apply to you. 


DISCLAIMER OF WARRANTY AND LIABILITY ON COMPUTER PROGRAMS. 

Most APX programs have been written by people not employed by Atari, Inc. The programs we 
select for APX offer something of value that we want to make available to ATARI Home 
Computer owners. To offer these programs to the widest number of people economically, we 
don't put APX products through rigorous testing. Therefore, APX produts are sold "as is", 
and we do not guarantee them in any way. In particular, we make no warranty, express or 
implied, including warranties of merchantability and fitness for a particular purpose. We 
are not liable for any losses or damages of any kind that result from use of an APX 
product. 




EXCHA3STGE 


REVIEW FORM 


We y re interested in your experiences with APX programs and documentation, both favorable and 
unfavorable* Many software authors are willing and eager to improve their programs if they know 
what users want* And, of course, we want to know about any bugs that slipped by us, so that the 
software author can fix them* We also want to know whether our documentation is meeting your needs 
You are our best source for suggesting improvements! Please help us by taking a moment to fill in 
this review sheet* Fold the sheet in thirds and seal it so that the address on the bottom of the 
back becomes the envelope front* Thank you for helping us! 

1* Name and APX number of program 

2* If you have problems using the program, please describe them here* 


3* What do you especially like about this program? 


4* What do you think the program's weaknesses are? 


5* How can the catalog description be more accurate and/or comprehensive? 


6* On a scale of 1 to 10, 1 being "poor'' and 10 being "excellent", please rate the following 
aspects of this program? 

Easy to use 

User-oriented (e*g*, menus, prompts, clear language) 

Enjoyable 

Self-instructive 

Useful (non-game software) 

Imaginative graphics and sound 


/♦ Describe any technical errors you found in the user instructions (please give page numbers)* 



3* What did you especially like about the user instructions? 


9* What revisions or additions would improve these instructions? 


10* On a scale of 1 to 10* 1 representing "poor" and 10 representing "excellent"* how would you 
rate the user instructions and why? 


11* Other comments about the software or user instructions* 


ISTAMPI 

I I 


ATARI Program Exchange 
Attn: Publications Dept* 
P*0* Box 50047 
60 E* Plumeria Drive 
San Jose* CA 95150 


[seal here] 
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